home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / sysext / init / kiss10b7.sit / Kiss Docs.c next >
Encoding:
Text File  |  1990-09-10  |  5.5 KB  |  135 lines
  1. /*
  2.  
  3. ========
  4. = Kiss =
  5. ========
  6.  
  7. version 1.0 (beta 7)
  8.  
  9. by Alex Chaffee
  10.  
  11. Reed College Box 259, Portland, OR 97202
  12. Compuserve: 71210,1117
  13. Internet: chaffee@reed.{uucp,bitnet} or chaffee%reed@tektronix.com
  14. America Online: AlexCh
  15.  
  16. Copyright ⌐ 1990 by Alex Chaffee.
  17.  
  18. Kiss may be freely distributed (with the limitations listed below), as
  19. long as this document and copyright information remain attached;
  20. however, if you decide to keep it, please send me a shareware fee of
  21. $10 ($5 for students; contact me if you'd like a site license), or a
  22. six-pack of your favorite local beer, or whatever you think it's
  23. worth.  At the very least, send me a postcard. This is the first time
  24. I've asked for shareware fees, because it's the first of my many
  25. projects I've thought was worth it.  And if you don't pay, you don't
  26. get new versions until everybody else has them too...
  27.  
  28. I grant permission for Kiss to be included in the libraries of on-line
  29. services and bulletin boards which do not charge extra (that is, more
  30. than their usual connect-time rates) for downloading time, in the
  31. libraries of non-profit users' groups (including collections such as
  32. the BMUG PD-ROM), and on public-access file servers.  Commercial 
  33. distribution requires written permission from the author.
  34.  
  35. What It Is
  36.  
  37. Kiss is an INIT that modifies the THINK C 4.0 editor to provide several useful
  38. features -- Word-Forward, Word-Backward, Page-Up, Page-Down, Home, End,
  39. Forward-Delete, Delete-Word, Mark and Parenthesis Kissing (hence the name).  
  40. Pressing Command or Option and the arrow keys do the first four, and the keys on 
  41. the Extended ADB Keyboard will now do what you think they should.  You can also 
  42. press shift and any of these to extend the selection.  (Extending the selection 
  43. still doesn't use the "anchor point" idea like Real Mac word processors, but only 
  44. makes the selection bigger; this is the way Think itself does it so I don't feel 
  45. too guilty. I may find this annoying enough to fix in a future version.)
  46.  
  47. If you press ')', ']', or '}', Kiss will search backwards to find the matching
  48. '(', '[', or '{', and briefly highlight it.  (If the mate is off the screen, you
  49. will see nothing.)  If it can't find a mate, it will beep.  This feature treats
  50. character and string constants correctly (i.e. <'{'> and <"\"">), and will not
  51. get confused if you have unmatching parentheses or quotes inside a comment.
  52.  
  53. Pressing Command-Space ("Set Mark") saves the current selection as the Mark.  If
  54. you press Command-Enter ("Jump To Mark"), Kiss will re-select the Mark and
  55. scroll to it. Pressing Option-Enter ("Swap Mark") does both of these at once, so
  56. that subsequent Swaps will bounce back and forth between the two selections.
  57.  
  58. Command Summary
  59.  
  60.       Cmd- Up/Down    Page Up/Down
  61.        PageUp/PageDown    Page Up/Down    
  62.       Opt- Up/Down    Home/End of File
  63.           Home/End    Home/End of File
  64.        Cmd- Left/Right    Start/End of Line
  65.        Opt- Left/Right    Previous/Next Word
  66.         Del/FwdDel    Delete Previous/Next Character
  67.        Opt- Del/FwdDel    Delete Previous/Next Word
  68.            ), }, ]    Kiss
  69.         Cmd- Space    Set Mark
  70.         Cmd- Enter    Jump To Mark
  71.         Opt- Enter    Swap Mark and Selection
  72.     
  73. What It Isn't
  74.  
  75. Kiss may not be perfect.  Please tell me whatever bugs you find.  If you're a
  76. registered (i.e. paid) user, I'll send you a copy of the latest version as it's
  77. written.  Until I get it out of the beta stages (any day now!), I plan to 
  78. distribute new versions only through Compuserve, America Online, and E-Mail.  
  79. If you don't have access to these, please tell me, and I'll send you a copy of 
  80. the final version as soon as it's finished.
  81.  
  82. And of course, Kiss may be improved.  If you have any suggestions on things
  83. you'd like Think to do, send them along and I'll think about them.  I may soon
  84. make Kiss a cdev, so you can disable or modify some of the features.  Actually,
  85. I've got an idea to write a cdev/INIT which will take the idea of Kiss to its
  86. limit and allow other programmers to write their own plug-in CODE resources to
  87. extend Think's editor.  If you'd like to brainstorm with me about this, please
  88. write (preferably via the Internet or Compuserve).
  89.  
  90. Just In Case
  91.  
  92. THINK C is a trademark of Symantec Corporation.
  93.  
  94. Known Bugs
  95.  
  96. Ñ    If the selection range extends more than one page away, Page-up and 
  97.     page-down only scroll one page, regardless of the actual
  98.     distance to the top or bottom of the new selection.
  99.     
  100. Ñ    I should really implement multiple marks for multiple files.  As it
  101.     stands, there's only one global mark, so if you set the mark in a new
  102.     file, it forgets the mark in the old one.
  103.  
  104. Ñ    Forward-delete only supports one character of Undo.
  105.     
  106. Version History
  107.  
  108. 2/24/90    Version 1.0 Beta 1 released
  109. 3/22    Beta 2 
  110.     - Fixed screen update bugs
  111.     - Kiss now ignores comments (but if you type a mismatched paren inside 
  112.       a comment, it'll match with one outside -- and it gets confused by 
  113.       more than one "/*" in a row -- got it?)
  114.     - Word-forward and -backward off the screen now scroll properly
  115.     - New icon
  116.     - Incidentally, if you use FunKey, ask me for a new version which is
  117.       fully compatible with Kiss.
  118. 3/28    Beta 3
  119.     - Fixed problem with kissing at the very beginning of the file
  120.     - Added Mark, added STR 128
  121.     - More screen update glitches fixed
  122. 5/18    Beta 4
  123.     - Now your copy of Think can be named anything you want
  124. 7/16    Beta 5
  125.     - Changed keys around to match Apple's guidelines: Next/Previous Word 
  126.       is now Option-Right/Left
  127.     - Added End/Start of Line (Command-Right/Left)
  128.     - Finally squashed the Cancel-Click-Bus Error bug
  129. 7/24    Beta 6
  130.     - Added Delete Word (Opt-Del/FwdDel)
  131. 9/10    Beta 7
  132.     - Fixed a stupid-ass bug that caused a fatal crash which, for some
  133.       strange reason, I never encountered personally.
  134. */
  135.